6.1.3 建立OTC代付訂單

#簡要描述： 透過OTC實現法幣提款

• 要求方式: POST
• 請求介面: https://网关域名/wallet-trade-merchant/v1/otc/payment/create
• 請求媒體類型( JSON 資料格式 )Content-Type: application/json

請求參數

參數名稱	類型	必填	參數意義	參數說明
key	string	是	商家 key	apiKey
localOrderId	string	是	商家平臺本地訂單號碼	商家平臺本地產生唯一訂單號碼
localUserId	string	否	商家平臺本機使用者ID	商家平臺本機使用者ID
notifyUrl	string	否	回呼位址	下單處理成功後，由 API 回呼通知商家的位址（回調詳情說明在最下方）
currency	string	是	提款幣種	預設 CNY
amount	number	是	提款金額	可自訂定額（無法享有通路費折扣，預設此訂單交易速度為NOW）或透過文件6.1.2介面取得下單金額（此金額可享有通路費折扣） 可精確至兩位小數
method	string	是	收款方式	ALIPAY（支付寶）、UNIONPAY（銀聯卡）、WECHAT（微信）、DIGITAL_RMB（數位人民幣）
paymentData	json	是	收款資訊	可參考下方代碼請求範例
└payee └accountId ｜ └payee └accountId ｜ └bankName ｜ └payee └ └payee └9XQPH10QX2ppay （收款人姓名）、accountId（收款帳號）、cardNo（銀行卡號）、bankName（銀行名稱）、walletCode（數位人民幣編碼）	參數範例： 支付寶收款參數 { "payee":"柯南","accountId":13888888888} 微信收款參數 { "payee":"柯南","accountId":13888888888} 銀聯卡收款參數 { "payee":"柯南","cardNo":13888888888,"bankName":"中國銀行"} 數位人民幣收款參數 { "payee":"柯南","walletCode":13888888888}
speed	string	是	交易速度	可透過文件6.1.1介面取得(如果為NOW的話，代表此訂單不會進入符合池，會被運作直接手動處理)
sign	string	是	簽章	詳情請見簽章演算法

請求 json 範例

{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "899952123",
  "localUserId": "4114",
  "notifyUrl": "http://127.0.0.1:8080/merchant-demo1/notify/test",
  "currency": "CNY",
  "amount": 100,
  "method": "UNIONPAY",
  "paymentData": {
                    // 银联卡
                    "payee":"柯南",
                    "cardNo":13888888888,
                    "bankName":"中国银行"
                   
                   //  支付宝
                   // "payee":"柯南",
                   // "accountId":13888888888
                   
                   //  微信
                   // "payee":"柯南",
                   // "accountId":13888888888
                   
                   //  数字人民币
                   // "payee":"柯南",
                   // "walletCode":13888888888                
                  },
    "speed": "NOW",
    "sign":"c6e3c292bb8cafaea50d4001185e6112"
}

回應範例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
  。        "orderId": 415236189438341,
            "localOrderId": "899952123"
           }
}

回應data 參數說明

參數名稱	類型	參數意義
orderId	Long	訂單號碼
localOrderId	string	商家平台自訂訂單號碼

回呼詳情說明

回呼的方式是：POST application/json

回呼參數 json 範例

{ 
   "amount":"100",
   "currency":"CNY",
   "localOrderId":"8999521232121336",
   "merchantId":302992856974,
   "merchantUserId":"4114",
   "notifyTime":1766134282162,
   "orderCreateTime":1766133956739,
   "orderId":"423044353278405",
   "status":"SUCCESS",
   "sign":"563eabc8cff14e401d426ff385b643ba",
   "key":"9yUreYgTRtit39Dy"
}

參數名稱	類型	參與簽名	參數意義	參數說明
amount	decimal	是	訂單金額
currency	String	是	幣種
localOrderId	String	是	本地訂單號碼
merchantId	Long	是	商家號碼
merchantUserId	String	是	商家的使用者ID
notifyTime	Long	是	回呼時間
orderCreateTime	Long	是	訂單建立時間
orderId	String	是	訂單號碼
status	String	是	代付狀態	SUCCESS: 已完成 | FAIL:已失敗
sign	String	否	md5 簽名	詳情請看簽名演算法
key	String	是	api key

當您收到回呼通知後，請在處理完成後直接返回字串 success，表示已成功接收並處理該訊息。 系統在收到 success 回應後，將不再對該筆回呼進行重複發送。 若未收到期望回應（未回傳 success 或回傳異常），系統將依照階梯式重試機制重新傳送回呼通知，最多重試 14 次。 當前重試時間間隔依序為： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s